Get Command (Source Menu)

Command Remarks

Retrieves the most recent version of the selected items from the repository and creates read-only copies in your working folder. To retrieve a history version of an item, click Get in History Explorer dialog box. You should have a working folder set before using this command.

There are five possible outcomes using Get command:

When the file you are retrieving is not already in your working folder, Dynamsoft SourceAnywhere Hosted simply gets the file.
When the file in your working folder is identical to the file you are retrieving, and the local copy is read-only, Dynamsoft SourceAnywhere Hosted does not retrieve or modify the file in any way.
When the file in your working folder is identical to the file you are retrieving, and the local copy is writable, Dynamsoft SourceAnywhere Hosted does not replace the writable file but modifies the attribute of the file into 'read-only'.
When the file in your working folder is different from the copy in Dynamsoft SourceAnywhere Hosted repository, and your local copy is read-only, Dynamsoft SourceAnywhere Hosted replaces your local copy.
When the file in your working folder is different from the copy in Dynamsoft SourceAnywhere Hosted repository, and the local copy is writable, Dynamsoft SourceAnywhere Hosted behaves in the way you specify in Replace Writable option in Tools->Options->Files Tab.

In Dynamsoft SourceAnywhere Hosted, a merge may occur at Get command (only if the Replace writable option is set to Merge in Get dialog box). Merge on Get is very useful in the following two cases.

The file is not checked out to you. When a file is exclusively checked out by another user and you may have to modify your local copy first. After that user checks his changes into Dynamsoft SourceAnywhere Hosted, you can use the Get command to retrieve his changes and merge it with your own.

If the repository version of a file differs from your local copy of the file and the local copy is writable, the differences will be merged into the local copy when you perform the Get command. This is a two-way merge.
The file is checked out to you. In a multiple checkout situation (when the current repository is set to allow multiple checkouts), if multiple users have checked out a file and another user checks in the file with changes, you can use the Get command to retrieve another user's changes before checking in your version of the file.
The difference among the current version, the checked-out version and your local copy of the file will be merged into your local copy. This is a three-way merge.

The way how Dynamsoft SourceAnywhere Hosted determines if your local copy is different from the copy in Dynamsoft SourceAnywhere Hosted repository can be set in Compare files by option in Tools->Options->Files Tab.

Access Rights

You must have Read access right to use this command.

Dialog Box Items

If you have checked the Get Latest Version check box in Options->Command Dialogs tab, the Get Latest Version dialog box is displayed when you perform the Get Latest Version command.

To

Type the path of the folder where you want Dynamsoft SourceAnywhere Hosted to place the files. The default is the working folder of the selected file or project.

Recursive (project-level Get only)

Gets a project, including all descendants of the project. Each file in a subproject is copied into its own working folder, which can be a folder anywhere on your computer or an accessible remote computer. To override the working folder settings, and create a file structure that mirrors the project structure in Dynamsoft SourceAnywhere Hosted repository, use the Build Tree option.

Note: Cloaked subprojects will not be retrieved.

Build Tree-Override Working Folders (project-level Get only)

Overrides the working folder set for the subprojects involved in a recursive operation, and builds a project tree on your local computer that mirrors the project organization. Working folder settings for individual subprojects are ignored. Available only when you select the Recursive check box.

Make Writable

Sets the read/write flag so the file is writable. This is not the default behavior, but may be useful if you want to try a temporary change in the file, or want to rename the file after getting it.

This option is enabled when you have checked "Use read-only flag for files that are not checked out" in Tools->Options->Files Tab.

Set File Time

Sets the modification date/time of the local file when Dynamsoft SourceAnywhere Hosted gets a file. Select one of the following options in the dropdown list:

Current: Sets the modification date/time of the local copy to the current date and time.

Modification: Sets the modification date/time of the local copy to the date and time the file was last modified.

Check In: Sets the modification date/time of the local copy to the date and time the file was last checked in.

The default selected option in the Set File Time dropdown list is the option you specify in Set File Time option in Tools->Options->Files Tab.

Replace Writable

Determines how Dynamsoft SourceAnywhere Hosted behaves when you try to get a file that is already modified and marked as writable in your working folder. The way how Dynamsoft SourceAnywhere Hosted determines if your working folder copy is modified can be set in 'Compare files by' option in Tools->Options->Files Tab.

Select one of the following options from the dropdown list:

Ask: Asks you what you want Dynamsoft SourceAnywhere Hosted to handle the writable local copy.

Replace: Replaces the local copy with the file on the repository.

Skip: Leaves the local copy alone (not retrieving the latest version from the repository).

Merge: Attempts a three-way merge if the file has been checked out by multiple users including you and your local file version number is smaller than that on the server. Besides, skips the local file copy.

The default selected option in the Replace Writable dropdown list is the one you specify in Replace Writable item in Tools->Options->Files Tab.

End-of-line

The end-of-line terminator for mergeable files may be specified using this option.

The EOL Terminator may need to be changed if the operating system where the working folders reside differs from the operating system Dynamsoft SourceAnywhere Hosted Client is currently running on. For example, if Dynamsoft SourceAnywhere Hosted Client is running on a Windows operating system but needs to retrieve files to a working folder that is on a Mac OS, you can change the EOL Terminator to Mac(CR) so that files retrieved to the working folder will be displayed correctly.

The options for end-of-line terminator are as follows:

Native: Keeps the original EOL terminator(s).
Windows(\r\n): Uses CRLF
Unix(\n): Uses LF
Mac(\r): Uses CR

The default selected option in the End-of-line dropdown list is the option you specify in End-of-line option in Tools->Options->Files Tab.

Note: The EOL Terminator will not take effect if your local copy of file is the same as the one in the repository. The way how Dynamsoft SourceAnywhere Hosted determines if your working folder copy differs from the repository copy can be set in 'Compare files by' option in Tools->Options->Files Tab.

Retrieves the file or project from repository.

Close

Cancels the Get command and closes the dialog box.